package com.example.domain.repository;

import com.example.domain.entity.Cart;
import com.example.domain.entity.enums.CartStatus;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Optional;

/**
 * 购物车Repository
 * 
 * @author Means
 * @since 2025-10-27
 */
@Repository
public interface CartRepository extends JpaRepository<Cart, String> {
    
    // ========== 基础查询 ==========
    
    /**
     * 根据用户ID查询购物车
     * 
     * @param userId 用户ID
     * @return 购物车列表
     */
    List<Cart> findByUserId(String userId);
    
    /**
     * 根据用户ID和状态查询购物车
     * 
     * @param userId 用户ID
     * @param status 购物车状态
     * @return 购物车列表
     */
    List<Cart> findByUserIdAndStatus(String userId, CartStatus status);
    
    /**
     * 根据会话ID查询购物车
     * 
     * @param sessionId 会话ID
     * @return 购物车对象
     */
    Optional<Cart> findBySessionId(String sessionId);
    
    /**
     * 根据会话ID和状态查询购物车
     * 
     * @param sessionId 会话ID
     * @param status 购物车状态
     * @return 购物车对象
     */
    Optional<Cart> findBySessionIdAndStatus(String sessionId, CartStatus status);
    
    /**
     * 根据状态查询购物车
     * 
     * @param status 购物车状态
     * @return 购物车列表
     */
    List<Cart> findByStatus(CartStatus status);
    
    // ========== 组合查询 ==========
    
    /**
     * 查询用户的活跃购物车
     * 
     * @param userId 用户ID
     * @return 购物车对象
     */
    @Query("SELECT c FROM Cart c WHERE c.userId = :userId AND c.status = 'ACTIVE' ORDER BY c.updatedAt DESC")
    Optional<Cart> findActiveCartByUserId(@Param("userId") String userId);
    
    /**
     * 查询会话的活跃购物车
     * 
     * @param sessionId 会话ID
     * @return 购物车对象
     */
    @Query("SELECT c FROM Cart c WHERE c.sessionId = :sessionId AND c.status = 'ACTIVE'")
    Optional<Cart> findActiveCartBySessionId(@Param("sessionId") String sessionId);
    
    /**
     * 查询用户或会话的活跃购物车
     * 
     * @param userId 用户ID
     * @param sessionId 会话ID
     * @return 购物车对象
     */
    @Query("SELECT c FROM Cart c WHERE " +
           "((:userId IS NOT NULL AND c.userId = :userId) OR " +
           "(:userId IS NULL AND c.sessionId = :sessionId)) " +
           "AND c.status = 'ACTIVE' ORDER BY c.updatedAt DESC")
    List<Cart> findActiveCartsByUserOrSession(@Param("userId") String userId,
                                              @Param("sessionId") String sessionId);
    
    // ========== 时间范围查询 ==========
    
    /**
     * 查询指定时间之前创建的购物车
     * 
     * @param beforeTime 时间点
     * @param status 购物车状态
     * @return 购物车列表
     */
    List<Cart> findByCreatedAtBeforeAndStatus(LocalDateTime beforeTime, CartStatus status);
    
    /**
     * 查询指定时间之前更新的购物车
     * 
     * @param beforeTime 时间点
     * @param status 购物车状态
     * @return 购物车列表
     */
    List<Cart> findByUpdatedAtBeforeAndStatus(LocalDateTime beforeTime, CartStatus status);
    
    // ========== 分页查询 ==========
    
    /**
     * 根据用户ID分页查询购物车
     * 
     * @param userId 用户ID
     * @param pageable 分页参数
     * @return 购物车分页结果
     */
    Page<Cart> findByUserId(String userId, Pageable pageable);
    
    /**
     * 根据状态分页查询购物车
     * 
     * @param status 购物车状态
     * @param pageable 分页参数
     * @return 购物车分页结果
     */
    Page<Cart> findByStatus(CartStatus status, Pageable pageable);
    
    // ========== 统计查询 ==========
    
    /**
     * 统计用户的购物车数量
     * 
     * @param userId 用户ID
     * @return 购物车数量
     */
    Long countByUserId(String userId);
    
    /**
     * 统计用户指定状态的购物车数量
     * 
     * @param userId 用户ID
     * @param status 购物车状态
     * @return 购物车数量
     */
    Long countByUserIdAndStatus(String userId, CartStatus status);
    
    /**
     * 统计指定状态的购物车数量
     * 
     * @param status 购物车状态
     * @return 购物车数量
     */
    Long countByStatus(CartStatus status);
}

